This chapter describes how to configure and monitor the Data Link Switching protocol. It includes the following sections:
Use the CONFIG process to change the configuration of the router. The new configuration takes effect when the device is restarted.
To enter the configuration process, enter talk 6 (or t 6), at the OPCON (*) prompt. This brings you to the CONFIG> prompt as shown in the following example:
MOS Operator Console For help using the Command Line Interface, press ESCAPE, then '?' * talk 6 Gateway user configuration CONFIG>
If the CONFIG> prompt does not appear immediately, press the Enter key again.
All DLSw configuration commands are entered at the DLS config> prompt. To access this prompt, enter the protocol DLSw command as shown:
Config>protocol dls DLSw protocol user configuration DLSw config>
Before you begin any configuration procedure, use the list device command from the config prompt to list the interface numbers of different devices. If you need any further configuration command explanations, see the configuration commands described in this chapter.
This section summarizes and explains the DLSw configuration commands. The DLSw configuration commands enable you to create or modify a DLSw configuration. Table 37 provides a brief summary of each command. Enter all the DLSw configuration commands following the DLSw Config> prompt. Defaults for any command and its parameters are enclosed in brackets immediately following the prompt.
Changes made to the router's configuration do not take effect
immediately, but become part of the router's SRAM configuration when it
is restarted.
Table 37. DLSw Configuration Commands Summary
| Command | Function |
|---|---|
| ? (Help) | Displays all the commands available for this command level or lists the options for specific commands (if available). See "Getting Help". |
| Add | Adds an SDLC link station, a TCP neighbor IP address, a QLLC station or destination, cache entries, MAC address list entries, circuit priority overrides, or MAC cache explorer-overrides. |
| Ban | Allows access to the Boundary Access Node (BAN) configuration prompt so that BAN configuration commands can be entered. |
| Close-Sap | Closes a currently-opened service access point (SAP). DLSw uses SAPs for communication on interfaces that support LLC. |
| Delete | Removes configured SDLC link station, a TCP connection, a QLLC station or destination, cache entries, MAC address list entries, circuit priority overrides, or MAC cache explorer overrides. |
| Disable | Disables the DLSw protocol, SDLC link station, LLC disconnect function, dynamic neighbors, a QLLC station or interface, or local and remote MAC address list use. |
| Enable | Enables the DLSw protocol, SDLC link station, LLC disconnect function, dynamic neighbors, a QLLC station or interface, local and remote MAC address list use, or IPv4 DLSw precedence bit setting. |
| Join-Group | Allows DLSw neighbors to dynamically find each other. |
| Leave-Group | Removes the router from the specified DLSw group. |
| List | Displays information for SDLC link stations, SAPs, circuit priority, DLSw groups, DLSw global information, QLLC destinations, stations, and interfaces, cache entries, or MAC address list entries. The command also provides detailed information on TCP connections. |
| NetBIOS | Provides access to the NetBIOS configuration prompt. |
| Open-SAP | Allows DLSw to transmit data over the specified SAP. DLSw uses SAPs for communication on interfaces that support LLC. |
| Set | Configures LLC2 parameters, number of DLSw sessions, SRB segment number, TCP buffer size, memory allocation, protocol timers, circuit priority, parameters for dynamic neighbors, parameters for QLLC operation, and MAC address list-related parameters. |
| Exit | Returns you to the previous command level. See "Exiting a Lower Level Environment". |
Use the add command to configure an SDLC link station, a TCP neighbor IP address, a QLLC station or destination, cache entries, MAC address list entries, circuit priority overrides, and MAC cache explorer overrides.
Syntax:
Example: add cache-entry
Enter MAC Address [400000000000]? 10005a123456
Enter the DLSw neighbor IP Address [0.0.0.0]? 128.185.122.234
MAC cache entry has been created.
Example: add explorer-override
Enter MAC address value [000000000000]?400031740000 Enter MAC address mask [FFFFFFFFFFFF]?ffffffff0000 Database age timeout (0-1000 secs. Decimal)[0.0]?0 Max wait timer ICANREACH (1-1000 secs. Decimal) [2.0?] Neighbor priority wait timer (0,0-5.0 secs. Decimal) [2.0]?0 Time to delay sending test response (0.0-5.0 secs. Decimal) [0.0]? Forwarding explorers (E/L/D) [E]? Enter position in explorer override list to insert new entry .... Record number (0=add at end of list) [0]? Explorer override record has been created.
if ((<specific MAC address>AND<override's mask>) == <override's value>) match on explorer override is found; use override's value
A value of zero indicates that entries in this database should not be aged. This may be useful when running neighbor TCP connections over dial interfaces, but is not generally recommended because it disables a number of other DLSw functions.
A value of zero indicates that the neighbor priority feature is not to be used. There will be no cached DLSw peer information for the MAC address. A CANREACH is always sent and the first DLSw peer to send an ICANREACH is used (regardless of its priority).
Example: add mac-list
Enter MAC Address Value[400000000000]? 10005a000000
Enter MAC Address Mask [ffffff000000]?
MAC list entry has been created.
For the new entry to take effect, you must restart or commit the change using
't 5': SET MAC LIST
if ( (<frame's destination MAC address> AND <MAC Address Mask>)
== <MAC Address Value> )
match on MAC address list found; forward frame to this DLSw
Example: add priority
Enter range of source SAPs ..... Lower source sap value [0]? Upper source sap value [FE]? Enter range of source MAC addresses ..... Lower source MAC address [000000000000]? Upper source MAC address [FFFFFFFFFFFF]? Enter range of destination SAPs ..... Lower destination sap value [0]? Upper destination sap value [FE]? c Enter range of destination MAC addresses ..... Lower destination MAC address [000000000000]? 10005a000000 Upper destination MAC address [FFFFFFFFFFFF]? 10005affffff Enter desired circuit priorities ..... Priority for session traffic (C/H/M/L) [M]? c Priority for explorer traffic (C/H/M/L) [M]? m Enter position in circuit priority override list to insert new entry ..... Record number (0=add at end of list) [0]? Circuit priority override record has been created.
Syntax:
Enter the connection id (1-8 alphanumeric chars) [ ]? conn1 Destination MAC address [000000000000]? 400031740000 Destination SAP in hex [4]? QLLC destination record added/updated
Caution:
If a QLLC Destination record is configured with "ANYCALL", all calls are
accepted by DLSw (regardless of DTE address or connection id). Be
aware, there are security issues when accepting all incoming calls.
Interface # [0]? 1 PVC or SVC [PVC]? Logical channel number (1-4095) [0]? 2 Source MAC address [400000310104]? Source SAP in hex [4]? Destination MAC address [000000000000]? 400011112323 Destination SAP in hex [0]? 4 PU type (2/4/5) [2]? XID0 block num in hex (0-0xfff) [0]? XID0 id num in hex (0-0xfffff) [0]? New QLLC station record added
This address is required for each station and must be unique among all the source MAC addresses for QLLC and SDLC devices configured in the router. To work reliably, it also should be unique among all end-station MAC addresses in the DLSw network. The default value is constructed to be likely to be unique within the network. This and all DLSw MAC addresses are in noncanonical (token-ring) bit order format .
This address is not required. If you do not configure it, the QLLC station can only be the target of a DLSw session, and not the origin.
DLSw config>add sdlc Interface # [0]? 2 SDLC Address or 'sw' (switched call-in) [C1]? Source MAC address [4000112402C1]? 4000003174d1 Source SAP in hex [4]? Destination MAC address [000000000000]? 400000000002 Destination SAP in hex [0]? 4 PU type (1/2/4/5) [2]? XID0 block num in hex (0-0xfff) [0]? 017 XID0 id num in hex (0-0xfffff) [0]? 00001 Poll with TEST (T), SNRM (S), or DELAYED SNRM (D) [T]?
| Note: | The destination address cannot have a value of 0 if this is a switched SDLC call-in circuit (indicated by "sw" as the SDLC address). |
| Note: | The destination SAP cannot have a value of 0 if this is a switched SDLC call-in circuit (indicated by "sw" as the SDLC address). |
| Note: | You cannot set this parameter for a switched SDLC call-in circuit. A PU type of 2.0 is assumed. |
| Note: | If you set this parameter to a non-zero value for a switched SDLC call-in circuit, the configured information is placed in XID_0. For a switched SDLC call-in circuit, the configured XID_0 blcok num is used differently. The software assumes that the call-in station will always build its own XID_0. If this parameter is set to a non-zero value, the station's XID_0 is modified with the configured value. If this parameter is set to a zero value, the station's XID_0 is not modified. |
Enter the DLSw neighbor IP Address [0.0.0.0]? 128.185.14.1 Connectivity setup type (a/p) [p]? Transmit Buffer Size (Decimal) [5120]? Receive Buffer Size (Decimal) [5120]? Maximum Segment Size (Decimal) [1024]? Enable/Disable Keepalive? (E/D) - [D]? Enable/Disable NetBIOS SessionAlive Spoofing (E/D) [D]? Neighbor Priority (H/M/L) [M]?
Use the ban command to access the Boundary Access Node (BAN) configuration prompt. BAN commands are entered at the BAN configuration prompt (BAN config>). See "BAN" for an explanation of each of these commands.
Syntax:
Use the close-sap command to disable DLSw switching for the specified service access point (SAP). These SAPs are used by LLC for configuration on the network.
Syntax:
Example: close-sap
Interface #[1]? Enter SAP in hex (range 0-FE), or one of the following: 'SNA', 'NB', or LNM [0]? sna SAP(s) 0 4 8 C closed on interface 1
If you enter SAPs in hex, the range is 0 to FE and the SAP must be an even number.
If you enter SNA, SAPs 0, 4, 8, and C are closed.
If you enter NB, SAP F0 is closed.
If you enter LNM, SAPs 0, 2, D4, F2, F4, F8, and FC are closed.
Use the delete command to remove an SDLC link station, a TCP neighbor IP address, a QLLC station or destination, cache entries, MAC address entries, circuit priority overrides and MAC cache explorer overrides from the DLSw configuration.
Syntax:
Example: delete cache-entry
Enter mac cache record number [1]? 1 MAC cache entry has been deleted
Example: delete explorer-override
Enter explorer override record number [1]? Explorer override record has been deleted.
Example: delete mac-list
Enter mac list record number [1]? 1 Local MAC list entry 10005A000000 / FFFFFF000000 has been deleted. For the deletion to take effect, commit the change using 't 5': SET MAC-LIST.
Example: delete priority
Enter circuit priority override record number [1]? 1 Circuit priority override record has been deleted.
Syntax:
Example: del q destination
DLSw config>del qllc dest Enter the connection id (1-8 alphanumeric chars) [ ]? conn1 QLLC Destination record deleted
Example: del q station
DLSw config>del qllc st Interface # [0]? 2 PVC or SVC [PVC]? Logical channel number (1-4095) [0]? 4 QLLC station record deleted
Syntax:
Example: delete sdlc
Interface #[0]? 1 SDLC Address or 'sw' (switched dial-in) [C1]? Record deleted
Syntax:
Example: delete tcp
IP Address [0.0.0.0]? 128.185.14.1
Use the disable command to disable the DLSw protocol, an SDLC link station, the LLC disconnect function, dynamic neighbors, a QLLC station or interface, or use of local and remote MAC address lists.
Syntax:
Example: disable dy
This command does not affect switching function for LLC in DLSw. Use the close-sap command to stop LLC switching function.
Example: disable llc
Syntax:
Example: disable mac-list local
Use of local MAC list is DISABLED For the change to take effect, restart or commit the change using 't 5' : 'SET MAC-LIST'.
Example: disable mac-list remote
Use of remote MAC list is DISABLED For the change to take effect, restart or commit the change using 't 5' : 'SET MAC-LIST'.
Specifying "station" prevents a configured QLLC station from being the origin or target of DLSw sessions.
Syntax:
Example: dis q callin
Select the interface to be disabled for incoming QLLC calls: Interface # [0]? 1 Interface 1 is now disabled for incoming QLLC calls
Example: dis q station
Interface # [0]? 1 PVC or SVC [PVC]? Logical channel number (1-4095) [0] 2 This QLLC station has been marked disabled
Example: disable sdlc
Interface #[0]? 1 SDLC Address or 'sw' (switched dial-in) [C1]? Record updated
Use the enable command to enable the DLSw protocol,SDLC link station, LLC disconnect function, dynamic neighbors, a QLLC station or interface, or use of local and remote MAC address lists.
Syntax:
Example: enable dls
Example:
enable IPv4 DLSw Precedence IPv4 Precedence is now enabled.
Syntax:
Example: enable mac-list local
Use of local MAC list is ENABLED For the change to take effect, restart or commit the change using 't 5' : 'SET MAC-LIST'.
Example: enable mac-list remote
Use of remote MAC list is ENABLED For the change to take effect, restart or commit the change using 't 5' : 'SET MAC-LIST'.
Specifying "station" allows a configured QLLC station to be the origin or target of DLSw sessions. This is the default state of every configured QLLC station.
Syntax:
Example: en q callin
Select the X.25 interface to be enabled for incoming QLLC calls: Interface # [0]? 1 Interface 1 now enabled for incoming QLLC calls
Example: en q station
Interface # [0]? 1 PVC or SVC [PVC]? Logical channel number (1-4095) [0]? 2 This QLLC station has been marked enabled
Example: enable sdlc
Interface #[0]? 1 SDLC Address or 'sw' (switched dial-in) [C1]? Record updated
Use the join-group command to enable DLSw neighbors to dynamically find and to create TCP sessions with each other, and to enable multicast exploring and frame forwarding. For an overview of these functions, see "TCP Connections, Neighbor Discovery, and Multicast Exploration". To use this command, the IP internet that is being used must support multicast routing, and you must configure OSPF and MOSPF from the OSPF Config> prompt.
When you add a DLSw router to a group, you select whether you want to use the group ID model of group identification (where the router constructs the corresponding multicast addresses), or specify the multicast addresses yourself. The group ID model is simpler to configure, but you must specify the multicast addresses yourself if you wish to have multicast connectivity with non-IBM DLSw Version 2 products. A router may be a member of both styles of groups at the same time.
You may join a maximum of 64 groups using the Group ID model. When you assign a DLSw router to a group, the DLSw protocol automatically adds one of two addresses to the group number to form a multicast address. The router transmits the multicast address to identify itself to other group members and to transmit packets to those members. The two addresses that are added to the group number are 225.0.1.0 for DLSw clients and peers, and 225.0.1.64 for DLSw servers. For example, the multicast address for a client in group 2 would be 225.0.1.2.
Syntax:
Example:
The following example is for the default [G]. The descriptions following the example contains information for both (G) and (M).
DLSw config>join Configure group member (G) or specific multicast address (M) - [G]? Group ID (1-64 Decimal) [1]? 2 Client/Server or Peer Group Member(C/S/P)- [P]? c Connectivity Setup Type (a/p) [p]? Transmit Buffer Size (Decimal) [5120]? Receive Buffer Size (Decimal) [5120]? Maximum Segment Size (Decimal) [1024]? Enable/Disable Keepalive (E/D) [D]? Enable/Disable NetBIOS SessionAlive Spoofing (E/D) [D]? Neighbor Priority (H/M/L) [M]?
Use the leave-group command to remove the router from a group that was configured using the join-group command, or to stop using a configured multicast address.
Leave-group does not affect existing TCP connections belonging to the specified group.
Syntax:
Example: leave-group
Configure group member (G) or specific multicast address (M) - [G]? Group ID (1-64 Decimal) [1]? 2
Use the list command to display DLSw information on SDLC link stations, circuit priority, SAPs, TCP neighbors, groups, dynamic neighbors, QLLC stations, destinations, interfaces, cache entries, MAC address list entries, circuit priority overrides, and MAC cache explorer overrides.
Syntax:
Syntax:
Example: cache all
Entry Mac Address IP Address
----- ------------ ---------------
1 10005A123456 128.185.236.49
2 10005A789ABC 128.185.236.49
Example: cache entry-number
Enter mac cache record number [1]?
Entry Mac Address IP Address
----- ------------ ---------------
1 10005A123456 128.185.236.49
Example: list dls
(Output from the list dls command is the same as the output from the list dls global command. See page *** for an example of this output.)
Example: list explorer-override
Explorer Explorer DB Age Wait ICR Nbr Pri TESTrsp Forwarding ID MAC Value MAC Mask Timeout Timeout Timeout Delay Explorers -- ------------ ------------ -------- -------- -------- ------- --------- 1 400031740000 FFFFFFFF0000 DISABLED 20 DISABLED 0.0 AllPartners 2 10005A000000 FFFFFF000000 1200 20 2.0 0.0 NoPartner
Example: list llc2
SAP t1 t2 ti n2 n3 tw rw nw acc 0 1 1 30 8 1 2 2 1 0
Syntax:
Example: list mac-list all
Entry Mac Value Mac Mask
----- ------------ ------------
1 10005A000000 FFFFFF000000
2 400031740000 FFFFFFFF0000
Example: list mac-list entry-number
Enter mac list record number [1}?
Entry Mac Value Mac Mask
----- ------------ ------------
1 10005A000000 FFFFFF000000
Example: list open
Interface SAP(s)
0 0 4
1 0 4 8 C
DLSw config> list priority
Default priority for SNA DLSw session traffic is MEDIUM
Default priority for NetBIOS DLSw session traffic is MEDIUM
Default priority for SNA DLSw explorer traffic is MEDIUM
Default priority for NetBIOS DLSw explorer traffic is MEDIUM
Message allocation by C/H/M/L priority is 4/3/2/1
Maximum frame size for NetBIOS is 2052
Source/ SAP MAC Address Session Explorer
ID Dest Range Range Priority Priority
-- ------- ------- --------------------------- -------- --------
1 Source: 00 - FE 000000000000 - FFFFFFFFFFFF CRITICAL MEDIUM
Dest : 00 - 0C 10005A000000 - 10005AFFFFFF
2 Source: 04 - 04 400031740000 - 40003174FFFF CRITICAL MEDIUM
Dest : 00 - FE 000000000000 - FFFFFFFFFFFF
Circuit priorities are Critical, High, Medium, or Low. The router uses the priority value you assign to selectively limit the burst-length of specific types of traffic. For example, if you assign SNA traffic a priority of Critical and NetBIOS session traffic a priority of Medium, with a message allocation of 4/3/2/1, the router processes 4 SNA session frames before it processes 2 NetBIOS frames, and so on. In this example, two-thirds of available bandwidth is dedicated to SNA traffic. When the router allocates bandwidth using priorities you specify, it counts frames rather than bytes.
Syntax:
Example: li q callin
Interfaces enabled for incoming QLLC calls to DLSw:
1
Example: li q destination
Connection ID Dest SAP/MAC CHICAGO 04 400000112323
For a description of the parameters, see the add qllc destination command on page ***.
Example: li q station
1f P/S LCN/DTE addr E/D Source SAO/MAC Dest Sap/MAC PU Blk/IdNum 1 PVC 2 E 04 400000310104 04 400011112323 2 000/00000 1 PVC 4 E 04 400000317402 04 400000000002 2 017/00001 1 SVC 3721111 E 04 400000310103 00 000000000000 2 000/00000
The parameters listed here are discussed on page ***. The "E/D" indicates whether the station was disabled via the disable qllc station command.
| Note: | Switched SDLC call-in circuits are indicated by "FF(sw)" in the address field. |
Example: list sdlc all
Net Addr Status Source SAP/MAC Dest SAP/MAC PU Blk/IdNum PollType 2 C1 Enabled 04 4000003174D1 00 400000000002 2 000/00000 TEST 2 C2 Enabled 04 4000103D01C2 00 000000000000 4 2 C3 Enabled 04 4000103D01C2 00 000000000000 2 017/00001 SNRM 3 FF(sw) Enabled 04 4000103d01d2 04 400000000003 2 017/00002
Example: list tcp
Xmit Rcv Max Keep- SesAlive Neighbor CST Bufsize Bufsize Segsize Alive Spoofing Priority --------------- --- ------- ------- ------- -------- -------- -------- 128.185.122.234 p 5120 5120 1024 DISABLED DISABLED MEDIUM 128.185.14.1 p 5120 5120 1024 DISABLED DISABLED MEDIUM
Example: list timers
Database age timer 1200 seconds Max wait timer for ICANREACH 20 seconds Wait timer for LLC test response 15 seconds Wait timer for SDLC test response 15 seconds QLLC session retry timer 20 seconds Join Group Interval 900 seconds Neighbor priority wait timer 2.0 seconds Neighbor Inactivity Timer 5 minutes Time to delay sending test resp. 0.0 seconds
For additional information, refer to the list timers command.
Displays the NetBIOS configuration prompt.
For a description of NetBIOS commands, see "NetBIOS Commands".
Syntax:
Issue the open-sap command for all SAPs you wish DLSw to use, either as the originator or as the target of DLSw circuits. The commonly-used SNA SAP values are 00, 04, 08, and 0C; all these SAPs can be opened together using the mnemonic "SNA". The NetBIOS SAP is F0 and can be referred to as "NB". SAPs related to the LAN Network Manager function are referred to collectively as "LNM". Open the SAPs for the protocols you select, on the interfaces through which DLSw will be reaching SNA or NetBIOS end stations, LNM, or the bridges that LNM is managing.
Syntax:
Example: open-sap
Interface #[1]? Enter SAP in hex (range 0-FE), or one of the following: 'SNA', 'NB', or LNM [4]? sna SAP(s) 0 4 8 C opened on interface 1
If you enter SAPs in hex, the range is 0 to FE and the SAP must be an even number. If you enter SAP 4, 8, or C without having previously opened SAP 0 on the same interface, SAP 0 will be opened automatically for you.
If you enter SNA, SAPs 0, 4, 8, and C are opened.
If you enter NB, SAP F0 is opened.
If you enter LNM, SAPs 0, 2, D4, F2, F4, F8, and FC are opened.
Use the set command to configure the size of the MAC address-to-IP address mapping cache, the LLC2 parameters, the maximum number of DLSw sessions, the SRB segment number, protocol timers, TCP receive buffer size, TCP dynamic neighbors, parameters for QLLC operation, MAC address list related parameters and circuit priority overrides.
Syntax:
DLSw uses information stored in this cache to discover routes to remote stations. The larger the cache, the better the chances of DLSw finding a desired remote station without sending out CANUREACH frames to all known TCP/IP neighbors.
Nonetheless, you should avoid setting this cache size too large. Doing so will use up memory on the router and cut into the memory needed for actual DLSw sessions. The effect will be a reduction in the number of DLSw sessions that can be handled by the router.
Example: set cache
MAC IP cache size (4 - 65535) [128]?
Example: set dyn
Transmit Buffer Size (Decimal) [5120]? Receive Buffer Size (Decimal) [5120]? Maximum Segment Size (Decimal) [1024]? Enable/Disable Keepalive (E/D) [D]? Enable/Disable NetBIOS SessionAlive Spoofing (E/D) [D]? Neighbor Priority (H/M/L) [M]?
For a description of the parameters listed here, see the add tcp command on page ***.
Example: set explorer-limit
Max SNA explorers per transport queue (0-1000)[100]? Max NB explorers per transport queue (0-1000)[100]? DLSW explorer limit values have been set.
Enter SAP in hex (range 0-F0) [0]? 04 Reply timer (T1) in sec. [1]? Receive Ack timer (T2) in 100 millisec. [1]? Inactivity Timer (Ti) in sec. [30]? Transmit Window (Tw), 1-127, 0=default [2]? Receive Window (Rw), 127 Max [2]? Acks needed to increment Ww (Nw) [1]? Max Retry value (N2) [8]? Number I-frames received before sending ACK (N3) [1]?
To ensure good performance, set N3 to a value less than the remote LLC's Tw. Default is 1.
Example: set mac-list
Local MAC list exclusivity (E=exclusive, N=non-exclusive) [N]? e MAC list parameter set. For the change to take effect, restart or commit the change using 't 5' : 'SET MAC-LIST'.
Example: set maximum
Maximum number of DLSw sessions (1-60000) [1000]?
The router does not currently use the overall DLSw allocation value, so this can be left at its default. Any DLS.161 messages that refer to the global transmit and receive pools (not the NetBIOS UI-frame pool) can be ignored. Instead of using these logical pools, DLSw pacing algorithms use the status of physical memory to determine the window sizes to advertise.
The LLC, SDLC, and QLLC session allocation values provide per-circuit (end-station pair) limits on the buffering of data flowing from LLC, SDLC, and QLLC-attached devices, respectively, to TCP. When the router reaches these limits, it sends RNRs/RRs to the appropriate end stations. The state of the per-session pools is visible from the DLSw monitoring command list dlsw memory as part of the list of active sessions.
Example: set memory
Number of bytes to allocate for DLSw (at least 2638)[140800]? Number of bytes to allocate per LLC session [8192]? Number of bytes to allocate per SDLC session [4096]? Number of bytes to allocate per QLLC session [4096]? Number of bytes to allocate for NetBIOS UI-frames [40960]?
The NetBIOS UI-frame allocation controls how many UI-frames (includes NetBIOS DATAGRAM, NAME_QUERY, ADD_NAME_QUERY, and so on) DLSw can buffer at any one time. When at this limit, DLSw discards received NetBIOS UI-frames and they must be retransmitted by the originating end-station. Setting this limit too low can therefore cause intermittent failure of NetBIOS circuit establishment attempts. The router reports a frame discard condition using ELS message DLS.161 (referring to the global NetBIOS UI-frame pool).
Lets you specify the circuit priorities to use for SNA circuits and NetBIOS circuits as well as letting you specify a traffic ratio between these priorities. You can use the set priority command to specify circuit priority as Critical, High, Medium, or Low (in descending order from Critical to Low). The router uses the priority values you assign to selectively limit the burst-length of specific types of traffic it is transmitting to its neighbors.
This function operates only during periods of congestion, when DLSw messages queue up before being sent to TCP. For example, you might assign SNA traffic a session and explorer priority of Critical, which corresponds by default to a message allocation value of 4. If you then assign NetBIOS session and explorer traffic a priority of Medium, which corresponds to a message allocation of 2, the router transmits 4 SNA frames before it transmits 2 NetBIOS frames. When the router processes 2 NetBIOS frames, it processes 4 SNA frames again, and so on. When allocating bandwidth using your assigned priorities, the router counts frames rather than bytes. Also, a particular circuit's priority is negotiated with the neighbor router at circuit bring-up time; consequently, the neighbor router may establish a new circuit's priority using some policy other than one based on configuration values you specified for this router. You might also want to assign different priorities to your SNA and NetBIOS session and explorer traffic.
You also can use the set priority command to set a maximum frame size for all NetBIOS circuits going through this router. NetBIOS end-stations have a tendency to generate the largest frames allowed, resulting in a single frame on a low-speed link occupying that link for several seconds, thus adversely affecting interactive SNA traffic. To reduce this effect, you can set a smaller maximum frame size value which the router signals to NetBIOS end stations using standard source-route bridging mechanisms. If you have transparently bridged (TB) segments in your network that are running NetBIOS, set the maximum NetBIOS frame size to at least 1470.
Example: set priority
Default priority for SNA DLSw session traffic (C/H/M/L) [M]? Default priority for NetBIOS DLSw session traffic (C/H/M/L) [M]? Default priority for SNA DLSw explorer traffic (C/H/M/L) [M]? Default priority for NetBIOS DLSw explorer traffic (C/H/M/L) [M]? Message allocation by C/H/M/L priority (4 digits) [4/3/2/1]? Maximum NetBIOS frame size (516, 1470, 2052, or 4399) [2052]? 516
You specify the range by providing a base MAC address "X" for the range, and a maximum number "N" of dynamic addresses. DLSw chooses MAC addresses in the range X to X+(N-1).
Example: set qllc
QLLC base MAC address [40514C430000]? Maximum QLLC dynamic addresses (0-max sess) [64]?
Example: set srb
Enter segment number hex (1-FFF) [5]?
DLSw config>set timers Database age timeout (0-10000 secs. Decimal) [1200]? 480 Max wait timer ICANREACH (1-1000 secs. Decimal) [20]? Wait timer LLC test response (1-1000 secs. Decimal) [15]? Wait timer SDLC test response (1-1000 secs. Decimal) [15]? QLLC session retry timer (1-1000 secs. Decimal) [20]? Group join timer interval (1-60000 secs. Decimal) [900]? 180 Neighbor priority wait timer (0, 1.0-5.0 secs. Decimal) [2.0]? Neighbor Inactivity Termination Timer (0-255 minutes) [5]? Time to delay sending test response (0.0-5.0 secs. Decimal) [0.0]? DLSw timer values have been set.
A value of zero indicates that entries in this database should not be aged. This may be useful when running neighbor TCP connections over dial interfaces, but is not generally recommended because it disables a number of other DLSw functions.
A value of zero indicates that the neighbor priority feature is not to be used. There will be no cached DLSw peer information for each MAC address. A CANUREACH is always sent and the first DLSw peer to send an ICANREACH is used (regardless of its priority).
This section describes the DLSw monitoring commands. These commands take effect immediately but do not become part of router's SRAM configuration. Thus, while monitoring commands enable you to make real-time changes to the router's configuration, these changes are overridden by the SRAM configuration when the router is restarted. Monitoring consists of these actions:
To enter the DLSw monitoring environment (GWCON process), enter talk 5 (or t 5) at the OPCON (*) prompt and protocol dls at the GWCON (+) prompt as shown in the following example:
MOS Operator Console For help using the Command Line Interface, press ESCAPE, then '?' * talk 5 + protocol dls DLS>
This section describes the DLSw Monitoring commands listed in Table 38. Use these commands to gather information from the
database.
Table 38. DLSw Monitoring Commands Summary
| Command | Function |
|---|---|
| ? (Help) | Displays all the commands available for this command level or lists the options for specific commands (if available). See "Getting Help". |
| Add | Dynamically adds an SDLC link station, a TCP neighbor IP address, a QLLC station or destination, cache entries, MAC address list entries, circuit priority overrides, or MAC cache explorer overrides to the current configuration. |
| BAN | Allows you to access the Boundary Access Node (BAN) console prompt for entering specific BAN console commands. See "Using the Boundary Access Node (BAN) Feature" for a detailed description. |
| Close-Sap | Dynamically closes a currently opened LLC SAP. LLC interfaces use SAPs for communication on the network. |
| Delete | Dynamically removes an SDLC link station, a DLSw session, a TCP neighbor IP address, a QLLC station or destination, cache entries, mac address list entries, circuit priority overrides, and MAC cache explorer overrides. |
| Disable | Dynamically disables the LLC switching function, an SDLC link station, dynamic neighbors, a QLLC station or interface, or use of local and remote mac address lists. |
| Enable | Dynamically enables the LLC switching function, an SDLC link station, dynamic neighbors, a QLLC station or interface, or use of local and remote mac address lists. |
| Join-Group | Dynamically adds the router to a DLSw group that is different from the SRAM configuration. |
| Leave-Group | Dynamically removes the router from the specified DLSw group. |
| List | Displays information for SDLC link stations, SAPs, circuit priority, DLSw groups, DLSw sessions, sessions for QLLC destinations, stations, and interfaces, cache entries, and mac address list entries. The command also provides detailed information on TCP capabilities, connections, and statistics. |
| NetBIOS | Provides access to the NetBIOS Support prompt. |
| Open-SAP | Dynamically opens an LLC SAP. |
| Set | Dynamically changes the LLC2 parameters, the maximum DLSw sessions, memory allocation, protocol timers, circuit priority, parameters for dynamic neighbors, parameters for QLLC operation, or mac address list related parameters. |
| Test | Test particular MAC addresses against the current MAC address cache and MAC address lists. |
| Exit | Returns you to the previous command level. See "Exiting a Lower Level Environment". |
Use the add command to dynamically configure an SDLC link station, a TCP neighbor IP address, a QLLC station or destination, cache entries, mac address list entries, circuit priority overrides, and MAC cache explorer overrides without affecting the SRAM configuration.
Syntax:
For examples and field descriptions, see the add command in the configuration chapter at "Add".
Use the ban command to access the BAN (Boundary Access Node) monitoring prompt. Enter the ban command from the DLS> prompt.
Syntax:
Once you access the BAN monitoring prompt, you can begin entering specific monitoring commands. See "Using the Boundary Access Node (BAN) Feature" for an explanation of the BAN monitoring commands..
To return to the DLSw> prompt at any time, enter the exit command.
Use the close-sap command to dynamically disable DLSw's use of the specified SAP without affecting the DLSw SRAM configuration.
Syntax:
Example: close-sap
Interface #[1]? Enter SAP in hex (range 0-FE), or one of the following: 'SNA', 'NB', or LNM [0]? 04 SAP(s) 4 closed on interface 1
(An explanation of the close-sap parameters can be found on page ***.)
Use the delete command to dynamically remove an SDLC link station, DLSw session, a TCP neighbor IP address, a QLLC station or destination, cache entries, mac address list entries, circuit priority overrides, or MAC cache explorer overrides without affecting the DLSw SRAM configuration. Use of this command also terminates any existing session.
Syntax:
Example: delete cache-entry
Enter MAC Address [400000000000]? 10005a123456 MAC 10005A123456 / IP address 128.185.122.234 configured cache entry deleted.
Example: delete dls
Session identifier [1]?
Example: delete explorer-override
Enter explorer override record number [1]? Explorer override record has been deleted.
Example: delete mac-list
Enter mac list record number [1]? Local MAC list entry 10005A000000 / FFFFFF000000 has been deleted.
Example: delete priority
Enter circuit priority override record number [1]? Circuit priority override record has been deleted.
Syntax:
Enter the connection id (1-8 alphanumeric chars) [ ]? conn1 QLLC Destination record deleted
Example: del q station
Interface # [0]? 2 PVC or SVC [PVC]? Logical channel number (1-4095) [0]? 4 QLLC station record deleted
Example: delete sdlc
Interface #[0]? 1 SDLC Address or 'sw' (switched dial-in) [C1]? Link closed
Example: delete tcp
IP Address [0.0.0.0]? 128.185.14.1
Use the disable command to dynamically disable the LLC disconnect function, the DLSw protocol, an SDLC link station, dynamic neighbors, a QLLC station or interface, or use of local and remote mac address lists without affecting the DLSw SRAM configuration. Disabling the entire DLSw function from monitoring is not supported.
Syntax:
(Examples using parameters of the disable command can be found beginning on page ***.)
Use the enable command to dynamically enable the LLC disconnect function, an SDLC link station, dynamic neighbors, a QLLC station or interface, or use of local and remote address lists without affecting the DLSw SRAM configuration.
Syntax:
(Examples using parameters of the enable command can be found beginning on page ***.)
Use the join-group command to cause DLSw to start performing neighbor discovery, multicast exploration, and multicast frame forwarding functions.
For additional information and an example, see "Using DLSw".
Syntax:
Use the leave-group command to cause DLSw to stop performing neighbor discovery, multicast exploration, and multicast frame forwarding functions in the specified group or using the specified multicast address. This change is made without affecting the DLSw SRAM configuration. Leave-group terminates existing TCP connections brought up under the specified group or multicast address. For additional information and an example, see "Using DLSw".
Syntax:
Example:
Configure group member (G) or specific multicast address (M) - [G]? Group ID (1-64 Decimal) [1]? 2
Use the list command to display DLSw information on SDLC link stations, circuit priority, SAPs, TCP neighbors, groups, dynamic neighbors, QLLC stations, destinations and interfaces, configured cache entries, MAC address list entries and MAC cache explorer overrides.
Syntax:
Example: list dls global
DLSw is ENABLED LLC2 send Disconnect is ENABLED Dynamic Neighbors is ENABLED SRB Segment number 020 MAC <-> IP mapping cache size 128 Max DLSw sessions 1000 DLSw global memory allotment 141312 LLC per-session memory allotment 8192 SDLC per-session memory allotment 4096 QLLC per-session memory allotment 4096 NetBIOS UI-frame memory allotment 40960 Dynamic Neighbor Transmit Buffer Size 5120 Dynamic Neighbor Receive Buffer Size 5120 Dynamic Neighbor Maximum Segment Size 1024 Dynamic Neighbor Keep Alive DISABLED Dynamic Neighbor SessionAlive Spoofing DISABLED Dynamic Neighbor Priority MEDIUM QLLC base source MAC address 40514C430000 QLLC maximum dynamic addresses 64 Type of local MAC list NON-EXCLUSIVE Use of local MAC list is ENABLED Use of remote MAC list is ENABLED SNA explorer limit 100 NetBIOS explorer limit 100
Example: list dls session all
Source Destination State Flags Dest. IP Addr Id
1. 400000000003 04 500000000003 04 Connected 128.185.236.51 2
DLC Type Characters Content
SDLC 1-5 "SDLC "
6-7 Interface number
8 "-"
9-10 SDLC station address
11-12 " "
QLLC 1-5 "QLLC "
6-7 Interface number
8 "P" for PVC, or "S" for SVC
9-12 LCN for PVC, or last 4 bytes of
DTE address for SVC
APPN 1-4 "APPN"
5-12 " "
A - CONTACT MSG PENDING
B - SAP RESOLVE PENDING
C - EXIT BUSY EXPECTED
D - TCP BUSY
E - DELETE PENDING
F - CIRCUIT INACTIVE
Example: list dls sess appn
Source Destination State Flags Dest IP Addr Id -------------- --------------- --------- ------- -------------- ---- 1 APPN 04 400000000011 04 CONNECTED 187.7.239.11 0 2 APPN 04 400000000014 04 CONNECTED 142.7.245.14 1
Example: list dls session ban
BAN port number (user 0 for all ports) [0]? No active sessions
Example: list dls session dest
Destination MAC Address [40000000001]? 50000000003 Source Destination State Flags Dest. IP Addr Id 1. 400000000003 04 500000000003 04 Connected 128.185.236.51 2 2. 400000000002 04 500000000003 04 Connected 128.185.236.52 3
Example: list dls session detail
Session Identifier [1]?
Source Destination State Dest. IP Addr Id
1. 400000000003 04 500000000003 04 Connected 128.185.236.512 2
Personality: TARGET
XIDs sent: 2
XIDs rcvd: 0
Datagrams sent: 0
Datagrams rcvd: 0
Info frames sent: 15
Info frames rcvd: 0
RIF: 0620 0202 B0B 0
Local CID: 0136AF74:7E000021
Remote CID: 014AB030:7E000003
Priority: MEDIUM
Example: list dls session ip
Enter the DLS neighbor IP address [0.0.0.0]? 128.185.236.512
Source Destination State Dest. IP Addr Id
1. 400000000003 04 500000000003 04 Connected 128.185.236.512 2
Example: list dls sessions nb
Source Destination State Dest. IP Addr Id 1. 400000000003 F0 500000000003 F0 Connected 128.185.236.512 2
Example: list dls session range
Start [1]? Stop [1]? Source Destination State Dest. IP Addr Id 1. 400000000003 04 500000000003 04 Connected 128.185.236.512 2
Example: list dls session src
Source MAC Address [400000000001]? Source Destination State Flags Dest. IP Addr Id 1. SDLC 04 400000000002 04 Connected 10.1.49.401 1
| Note: | In this example source MAC address 400000000001 maps to the "SDLC 04" name. If you do not know the source MAC address required as a parameter for this command, then enter the list SDLC config all command to obtain this information. |
Example: list dls session state
DISCONECT = 0, RSLV_PEND = 1
CIRC_PEND = 2, CIRC_EST = 3
CIR_RSTRT = 4, CONN_PEND = 5
CONT_PEND = 6, CONNECTED = 7
DISC_PEND = 8, HALT_PEND = 9
REST_PEND = 10 WT_HALTNA = 11
CIRC_STRT = 12 HLT_NOACK = 13
Enter state value (0-10) [7]?
Source Destination State Flags Dest. IP Addr Id
1. 400000000003 04 10005AF181A4 04 Connected 128.185.236.84 0
2. 400000000002 04 400000000088 04 Connected 128.185.236.84 1
Example: list dls cache all
Mac Address Entry Type Secs to live IP Address(es) LFSize 1. 10005A123456 PERMANENT (not being timed) 128.185.236.84 0 2. 10005A789ABC STATIC (not being timed) 128.185.236.84 0 3. 10005AF1809B DYNAMIC 810 128.185.236.84 2052 4. 10005AF181A4 DYNAMIC 1170 128.185.236.84 2052 5. 400000000088 DYNAMIC 1170 128.185.236.84 2052
Example: list dls cache config
Mac Address IP Address Source Last Mod ------------ --------------- --------- --------- 10005A123456 128.185.236.84 PERMANENT UNCHANGED 10005A789ABC 128.185.236.84 STATIC ADDED
Example: list dls cache range
Start [1]?
Stop ]1]? 20
Mac Address Entry Type Secs to live IP Address(es) LFSize
1. 10005A123456 PERMANENT (not being timed) 128.185.236.84 0
2. 10005A789ABC STATIC (not being timed) 128.185.236.84 0
3. 10005AF1809B DYNAMIC 810 128.185.236.84 2052
4. 10005AF181A4 DYNAMIC 1170 128.185.236.84 2052
5. 400000000088 DYNAMIC 1170 128.185.236.84 2052
Example: list dls memory
Total DLSw bytes requested: 153600
Global receive pool bytes granted: 92160
Currently in use: 0
Global transmit pool bytes granted: 61440
Currently in use: 232
NetBIOS UI-frame pool total bytes: 40960
Currently in use: 0
Session Initial Current Congest DLC Xmits
Id Source Destination State alloc alloc State Queued
5. SDLC 04C1 04 400000000003 04 Connected 16384 16384 READY 0
6. 400000000003 04 0000c9001119 04 Connected 16384 16384 READY 0
The "Currently in use" field shows the total amount of memory currently allocated by DLS. This includes all session allocations and control messages.
The "Congest State" field provides information on flow control and can be any of the following:
The "DLC Xmits Queued" field shows the total number of frames queued for transmit in DLS to LLC or SDLC, plus the number queued within the DLC awaiting acknowledgment by the attached end station.
Example: list explorer-override
Explorer Explorer DB Age Wait ICR Nbr Pri TESTrsp Forwarding ID MAC Value MAC Mask Timeout Timeout Timeout Delay Explorers -- ------------ ------------ -------- -------- -------- ------- --------- 1 400031740000 FFFFFFFF0000 DISABLED 20 DISABLED 0.0 AllPartners 2 10005A000000 FFFFFF000000 1200 20 2.0 0.0 NoPartner
Example: list mac-list all
MAC Value MAC Mask IP Address ------------ ------------ --------------- 10005AF17F23 FFFFFFFFFFFF Local 10005AF1809B FFFFFFFFFFFF 128.185.236.84 4000189E2000 FFFFFFFFF000 128.185.236.84 4000189E3000 FFFFFFFFF000 Local
Example: list mac-list config
Entry Mac Value MAC Mask Source Last Mod
----- ------------ ------------ --------- ---------
1 10005AF17F23 FFFFFFFFFFFF STATIC UNCHANGED
2 4000189E3000 FFFFFFFFF000 STATIC UNCHANGED
Example: list mac-list local
LOCAL MAC List Type of MAC List (active) ....... EXCLUSIVE Type of MAC List (pending) ...... EXCLUSIVE MAC Value MAC Mask ------------ ------------ 10005AF17F23 FFFFFFFFFFFF 4000189E3000 FFFFFFFFF000
Example: list mac-list remote
Enter the DLSw neighbor IP Address [0.0.0.0]? 128.185.236.84 Partner IP Address .............. 128.185.236.84 Type of MAC List ................ EXCLUSIVE Use of remote MAC lists ......... ENABLED MAC Value MAC Mask ------------ ------------ 10005AF1809B FFFFFFFFFFFF 4000189E2000 FFFFFFFFF000
Example: list groups config
Group# Xmit Rcv Max Keep- SesAlive Mcast IP Addr Role CST Bufsize Bufsize Segsize Alive Spoofing Priority --------------- --------- --- ------- ------- ------- -------- -------- -------- 224.0.10.0 READWRITE p 5120 5120 1024 DISABLED DISABLED MEDIUM Group 2 PEER p 5120 5120 1024 DISABLED DISABLED MEDIUM
Example: list groups config
Group# / Xmit Rcv Max
Mcast IP Addr Role CST Bufsize Bufsize Segsize Keepalive
Priority
224.0.10.0 READ/WRITE p 5120 5120 1024 DISABLED MEDIUM
1 CLIENT p 5120 5120 1024 DISABLED MEDIUM
Example: list groups stat
Group number Data pkts Data Bytes Ctrl pkts CURex pkts NQex pkts
or Sent Sent Sent Sent Sent
Multicast IP@ Rcvd Rcvd Rcvd Rcvd Rcvd
------------- --------- --------- ---------- ---------- ---------
Group 1 0 0 116 24 10
0 0 25 10 2
224.0.10.0 0 0 224 33 0
0 0 21 8 0
Example: list llc2 open
Interface SAP(s)
0 0 4
1 0 4 8 C
Example: list llc2 sap parameters
SAP t1 t2 ti n2 n3 tw rw nw acc --- -- -- -- -- -- -- -- -- --- 0 1 1 30 8 1 2 2 1 0
Example: list llc2 sessions all
SAP Int. Remote Addr Local Addr State RIF 1. 04 6 400000000003 500000000003 CONTACTED 0620 0202 B0B0
Example: list llc2 sessions range
Start[1]?
Stop[1]?
SAP Int. Remote Addr Local Addr State RIF
1. 04 6 400000000003 500000000003 Contacted 0620 0202 B0B0
Example: list priority
Default priority for SNA DLSw session traffic is HIGH
Default priority for NetBIOS DLSw session traffic is MEDIUM
Default priority for SNA DLSw explorer traffic is MEDIUM
Default priority for NetBIOS DLSw explorer traffic is LOW
Message allocation by C/H/M/L priority is 4/3/2/1
Maximum frame size for NetBIOS is 516
Source/ SAP MAC Address Session Explorer
ID Dest Range Range Priority Priority
-- ------- ------- --------------------------- -------- --------
1 Source: 00 - FE 000000000000 - FFFFFFFFFFFF CRITICAL MEDIUM
Dest : 00 - 0C 10005A000000 - 10005AFFFFFF
2 Source: 04 - 04 400031740000 - 40003174FFFF CRITICAL MEDIUM
Dest : 00 - FE 000000000000 - FFFFFFFFFFFF
Syntax:
Example: li qllc callin
Interfaces enabled for incoming QLLC calls to DLSw:
1
Example: li qllc dest
Connection ID Dest SAP/MAC Hits CHICAGO 04 400000112323 0
For a description of the configurable fields in this display, see the add qllc command in "Using DLSw". The Hits field indicates the number of times that DLSw has used a match between the connection id in an incoming QLLC Call_Request packet and this connection id.
Example: li qllc sess
If P/S LCN/DTE addr Source SAP/MAC Dest SAP/MAC Type State
4 PVC 4 04 400000310401 00 000000000000 PERM NET_DOWN
4 SVC 3721111 04 400000310402 00 000000000000 STAT NET_DOWN
2 Circuits 1 PVC 1 SVC 1 Permanent 1 Static 0 Dynamic
For a description of the configurable fields in this display, see the add qllc command in "Using DLSw".
The Type field has the following values:
The summary line at the bottom of the session list shows how many sessions of each type currently exist.
The State field indicates the state of the DLSw connection from a QLLC point of view. These states are different from the main DLS states displayed under the list dls sess commands and add information about what is happening on the QLLC interface. Possible values are:
Example: li qllc sta
If P/S LCN/DTE addr E/D Source SAP/MAC Dest SAP/MAC PU Blk/IdNum Type 1 PVC 2 E 04 400000310104 04 400011112323 2 000/00000 PERM 1 SVC 3721111 E 04 400000310103 00 000000000000 2 000/00000 PERM 1 PVC 4 E 04 400000317402 04 400000000002 2 017/00001 PERM
For a description of the configurable fields in this display, see the add qllc command in "Using DLSw". The "E/D" field indicates whether the station is currently enabled. The "Type" field has the same values described above for the list qllc sessions command.
Example: list sdlc config
Interface #, or 'ALL' [0]? all Net Addr Status Source SAP/MAC Dest SAP/MAC PU Blk/Idnum PollType 1 C1 Enabled 04 4000103D01C1 00000000000000 2 000/00000 TEST 1 C2 Enabled 04 4000103D01C2 00000000000000 2 000/00000 SNRM 3 FF(sw) Enabled 04 4000103D01D2 04 400000000003 2 000/00000 TEST
Example: list sdlc sessions
Net Address Source SAP/MAC Dest SAP/MAC PU OutQ State 1. 1 C1 04 4000103D01C1 00 000000000000 2 0 NET_DOWN 2. 1 C2 04 4000103D01C2 00 000000000000 2 0 NET_DOWN
Because DLSw and SDLC have the ability to do full XID negotiation, it is possible that the attached SDLC link station will set the link to a different SDLC station address than that configured in the router. When this happens, two SDLC station addresses are shown under the "Addr" column of this display, using the format xx(yy). In this format, xx is the station address configured at this router and is still used for all configuration and monitoring commands to refer to this link station. The current operational address that was set by the attached SDLC device is the value yy shown in parentheses to the right.
Example: list tcp capabilities
Enter the DLSw neighbor IP Address [0.0.0.0]? 128.185.236.84
Vendor ID: 10005A
Vendor product version: IBM 2216 Nways MAS 2216-MAS
Initial pacing window: 12
Preferred TCP connections: 1
Supported SAPs: 00 04 08 0C F0
MAC List Exclusivity: Complete List
MAC List: 08005ACEEA1C [FFFFFFFFFFFF]
4000189E2000 [FFFFFFFFF000]
NetBIOS Exclusivity: (not supplied)
NetBIOS Name List: (none supplied)
Multicast Version: 01
IBM CST: Passive Transport
IBM Multicast: Available
IBM Capex Correlator: 19660
Example: list tcp config
Xmit Rcv Max Keep- SesAlive Neighbor CST Bufsize Bufsize Segsize Alive Spoofing Priority --------------- --- ------- ------- ------- -------- -------- -------- 128.185.236.84 p 5120 5120 1024 DISABLED DISABLED MEDIUM
Example: list tcp sessions
Group IP Address Conn State CST Version Active Sess Sess Creates ------- --------------- -------------- --- -------- ----------- ------------ 1 128.185.236.49 ESTABLISHED p AIW V1R0 2 4
a - Locally configured as active
p - Locally configured as passive
A - Locally configured as passive, but operating in active mode
due to neighbor requirements
D - Not locally configured, but a dynamic neighbor TCP connection
Example: list tcp statistics
Enter the DLSw neighbor IP Address -0.0.0.0-? 192.1.1.3
Transmitted Received
----------- -----------
Data Messages 214 231
Data Bytes 372997 413259
Control Messages 16 34
CanYouReach Explorer Messages 0 0
ICanReach Explorer Messages 0 0
NameQuery Explorer Messages 1 2
NameRecognized Explorer Messages 2 1
Example: list timers
Database age timer 1200 seconds Max wait timer for ICANREACH 20 seconds Wait timer for LLC test response 15 seconds Wait timer for SDLC test response 15 seconds QLLC session retry timer 20 seconds Join Group Interval 900 seconds Neighbor priority wait timer 2.0 seconds Neighbor Inactivity Timer 5 minutes Time to delay sending test resp. 0.0 seconds
Displays the NetBIOS monitoring prompt.
Syntax:
Example: netbios
NetBIOS Support User Configuration NetBIOS config>
For a description of NetBIOS commands, see "Configuring and Monitoring NetBIOS".
Use the open-sap command to dynamically enable DLSw switching for the specified service access point (SAP) without affecting the DLSw SRAM configuration.
Syntax:
Refer to "Open-Sap" for additional information and an explanation of the open-sap parameters.
Use the set command to dynamically change the LLC2 parameters, the maximum number DLSw sessions, protocol timers, TCP dynamic neighbors, parameters for QLLC operation, mac address list related parameters, and circuit priority parameters without affecting the DLSw SRAM configuration.
Syntax:
Syntax: dynamic-tcp
Example: set dyn
Transmit Buffer Size (Decimal) [5120]? Receive Buffer Size (Decimal) [5120]? Maximum Segment Size (Decimal) [1024]? Enable/Disable Keepalive (E/D) [D]? Enable/Disable NetBIOS SessionAlive Spoofing (E/D) [D]? Neighbor Priority (H/M/L) [M]?
For a description of these parameters, see the add tcp command in "Using DLSw".
Example: set explorer-limit
Max SNA explorers per transport queue (0-1000)[100]? Max NB explorers per transport queue (0-1000)[100]? DLSw explorer limit values have been set.
Example: set llc2
(An example of the set llc2 command can be found on page ***).
As a result of this command, a new run-time capabilities will be sent to all DLSw peers to communicate the new information.
Syntax: mac-list
Example: set mac-list
Local MAC list exclusivity (E=exclusive, N=non-exclusive) [N]? e MAC list parameter set. For the change to take effect, commit the change (next question). The next question allows you to commit any of the following changes (permanent and temporary): - changes made using ENABLE MAC-LIST LOCAL - changes made using ENABLE MAC-LIST REMOTE - changes made using DISABLE MAC-LIST LOCAL - changes made using DISABLE MAC-LIST REMOTE - changes made using ADD MAC-LIST - changes made using DELETE MAC-LIST - changes made using SET MAC-LIST Would you like to commit the MAC list changes? [No]: y Use of local MAC list remains ENABLED. Use of remote MAC list remains ENABLED. Type of local MAC list has changed from NON-EXCLUSIVE to EXCLUSIVE . Entry added temporarily: 08005ACEE5D9 / FFFFFFFFFFFF. Entry added temporarily: 4000189E3000 / FFFFFFFFF000. Would you still like to commit the MAC list changes? [No]: y MAC address list changes have been committed.
Example: set memory
An example of the use of the set memory command can be found on page ***.
This command also enables you to configure the ratio of transport transmits for each circuit priority, and to set the maximum frame size to use for NetBIOS. If your network contains any transparently bridged (TB) segments, use a maximum NetBIOS frame size of at least 1470.
Example: set priority
For more information on the set priority command, see page ***.
Specify the range by providing a base MAC address "X" for the range, and a maximum number "N" of dynamic addresses. DLSw chooses MAC addresses in the range X to X+(N-1).
Syntax:
Example: set qllc
DLSw config>set qllc QLLC base MAC address [40514C430000]? Maximum QLLC dynamic addresses (0-max sess) [64]?
Example: set timers
An example of the set timers command can be found on page ***.
Use the test command to perform tests against the currently active MAC address cache and MAC address list.
Syntax:
Syntax: cache
Example: test cache
MAC address to be tested [000000000000]? 10005af1809b
Enter largest frame size to perform test against [2052]?
Destination MAC address being tested .... 10005AF1809B
MAC cache entry found:
Entry type = DYNAMIC
Handling of SNA explorer SSP messages ....
Explorer SSP message not sent (information found locally).
Handling of SNA circuit setup SSP messages ....
Circuit Setup SSP message would be forwarded to 128.185.236.84
Handling of NetBIOS explorer SSP messages ....
Explorer SSP message would be broadcast.
How explorer destined for this MAC address is forwarded to DLSw partners
.....
Send to all partners with non-exclusive mac address lists.
There are currently no DLSw partners to forward the explorer to.
Handling of NetBIOS circuit setup SSP messages ....
No currently known transport that can support circuit setup for given lfsize.
Syntax: mac-list
Example: test mac-list
MAC address to be tested [000000000000]? 10005af1809b Destination MAC address being tested .... 10005AF1809B MAC address value MAC address mask IP Address ----------------- ----------------- --------------- 10005AF1809B FFFFFFFFFFFF 128.185.236.84